Pular para o conteúdo principal

Obter uma chave de API

App: Minotaur Sales API
Publicado por: Minotaur Sales
Compatível com: app.minotaursales.io


As chaves de API são gerenciadas na sua conta Minotaur. Você pode gerar uma chave diretamente pelo app ou via API.

Gerar pelo app

A forma mais simples de criar uma chave de API é diretamente pelo app Minotaur:

  1. Faça login em app.minotaursales.io.
  2. Acesse Configurações → Conexões → API Key.
  3. Clique em Gerar.
  4. Insira um nome e selecione um período de expiração (7, 30, 90 ou 365 dias).
  5. Selecione as permissões que a chave precisa.
  6. Clique em Confirmar. Copie a chave — ela é exibida apenas uma vez.

Chaves geradas pelo app funcionam de forma idêntica às criadas via API.

Gerar via API

Os endpoints abaixo requerem um token de sessão (Bearer <session_token>).

Criar uma chave

POST /api/api-key/generate
Authorization: Bearer <session_token>
Content-Type: application/json
{
"name": "Minha Integração",
"expiration": 30
}

Valores aceitos para expiration: 7, 30, 90, 365.

Listar chaves

GET /api/api-key
Authorization: Bearer <session_token>

Retorna os registros de chaves, nunca o valor bruto da chave.

Atualizar ou rotacionar uma chave

PATCH /api/api-key/update/:id
Authorization: Bearer <session_token>
Content-Type: application/json

Pode atualizar name e/ou expiration, e emite uma nova chave. A chave anterior para de funcionar imediatamente.

Revogar uma chave

PATCH /api/api-key/revoke/:id
Authorization: Bearer <session_token>

A revogação é permanente e não pode ser desfeita.

Notas importantes

  • O valor da chave aparece apenas uma vez ao gerar/rotacionar.
  • Salve as chaves em um gerenciador de segredos.
  • Para mudar permissões, rotacione a chave.